docs: Update the README

diff --git a/README.in b/README.in
deleted file mode 100644 (file)
index 9315f92..0000000
--- a/README.in
+++ /dev/null
@@ -1,82 +0,0 @@
-General Information
-===================
-
-This is GTK+ version @GTK_VERSION@. GTK+ is a multi-platform toolkit for
-creating graphical user interfaces. Offering a complete set of widgets,
-GTK+ is suitable for projects ranging from small one-off projects to
-complete application suites.
-
-GTK+ is free software and part of the GNU Project. However, the
-licensing terms for GTK+, the GNU LGPL, allow it to be used by all
-developers, including those developing proprietary software, without any
-license fees or royalties.
-
-The official download locations are:
-  ftp://ftp.gtk.org/pub/gtk
-  http://download.gnome.org/sources/gtk+
-
-The official web site is:
-  http://www.gtk.org/
-
-Information about mailing lists can be found at
-  http://www.gtk.org/mailing-lists.php
-
-
-Installation
-============
-
-See the file 'INSTALL'
-
-
-How to report bugs
-==================
-
-Bugs should be reported to the GNOME bug tracking system.
-(http://bugzilla.gnome.org, product glib.) You will need
-to create an account for yourself.
-
-In the bug report please include:
-
-* Information about your system. For instance:
-
-   - What operating system and version
-   - For Linux, what version of the C library
-
-  And anything else you think is relevant.
-
-* How to reproduce the bug.
-
-  If you can reproduce it with one of the test programs that are built
-  in the tests/ subdirectory, that will be most convenient.  Otherwise,
-  please include a short test program that exhibits the behavior.
-  As a last resort, you can also provide a pointer to a larger piece
-  of software that can be downloaded.
-
-* If the bug was a crash, the exact text that was printed out
-  when the crash occurred.
-
-* Further information such as stack traces may be useful, but
-  is not necessary.
-
-
-Patches
-=======
-
-Patches should also be submitted to bugzilla.gnome.org. If the
-patch fixes an existing bug, add the patch as an attachment
-to that bug report.
-
-Otherwise, enter a new bug report that describes the patch,
-and attach the patch to that bug report.
-
-Patches should be in unified diff form. (The -up option to GNU diff)
-Even better are git-formatted patches. (Use git format-patch)
-
-
-Release notes
-=============
-
-Release notes for releases of GTK+ 3.x are part of the migration
-guide in the GTK+ documentation. See
-
-https://developer.gnome.org/gtk3/unstable/gtk-migrating-2-to-3.html

diff --git a/README.md b/README.md
new file mode 100644 (file)
index 0000000..3b79950
--- /dev/null
+++ b/README.md
@@ -0,0 +1,70 @@
+General Information
+===================
+
+GTK is a multi-platform toolkit for creating graphical user interfaces.
+Offering a complete set of widgets, GTK is suitable for projects ranging
+from small one-off projects to complete application suites.
+
+GTK is free software and part of the GNU Project. However, the licensing
+terms for GTK, the GNU LGPL, allow it to be used by all developers,
+including those developing proprietary software, without any license fees or
+royalties.
+
+The official download locations are:
+
+- http://download.gnome.org/sources/gtk+
+
+The official web site is:
+
+- http://www.gtk.org/
+
+Installation
+============
+
+See the file [`INSTALL.md`](./INSTALL.md)
+
+
+How to report bugs
+==================
+
+Bugs should be reported to the [GTK issue
+tracker](https://gitlab.gnome.org/GNOME/gtk/issues). You will need to create
+an account for yourself.
+
+In the bug report please include:
+
+* Information about your system. For instance:
+
+   - What operating system and version
+   - For Linux, what version of the C library
+
+  And anything else you think is relevant.
+
+* How to reproduce the bug.
+
+  If you can reproduce it with one of the test programs that are built
+  in the tests/ subdirectory, that will be most convenient.  Otherwise,
+  please include a short test program that exhibits the behavior.
+  As a last resort, you can also provide a pointer to a larger piece
+  of software that can be downloaded.
+
+* If the bug was a crash, the exact text that was printed out
+  when the crash occurred.
+
+* Further information such as stack traces may be useful, but
+  is not necessary.
+
+
+Bug fixes and improvements
+==========================
+
+Changes should be submitted as merge request to the GTK project. If a merge
+request fixes an issue, the description should mention the issue number.
+
+Release notes
+=============
+
+Release notes for releases of GTK 3.x are part of the migration
+guide in the GTK documentation. See
+
+- https://developer-old.gnome.org/gtk3/3.24/gtk-migrating-3-x-to-y.html